home *** CD-ROM | disk | FTP | other *** search
/ Hand Picked Software / Hand Picked Software.iso / cdrom / cd_v18 / cd-v.doc next >
Text File  |  1995-03-13  |  13KB  |  290 lines
  1. ===============================================================================
  2.                           CD-V     ver     1.8
  3. ===============================================================================
  4.  
  5.                          An Audio-CD VGA Player
  6.  
  7.                              Itamar Grutman
  8.                                  Israel
  9.                                   1994
  10.  
  11. ===============================================================================
  12.  
  13.     This program may not be sold, nor be made part of anything that is sold.
  14.  
  15. ===============================================================================
  16.  
  17.  
  18. 0. Contents
  19. ===========
  20.  
  21. 0.   Contents
  22. 1.   Decription
  23. 2.   Instructions
  24. 2.1.    Screen Saver
  25. 2.2.    Configuration
  26. 2.3.    Track Order Selection
  27. 2.4.    AutoRepeat
  28. 3.   Requirements
  29. 4.   Author
  30. 5.   Thanks
  31. 6.   Registration
  32. 7.   History
  33.  
  34.  
  35. 1. Description
  36. ==============
  37.     This program was written to fulfill my need for a VGA-based audio-cd player
  38. for DOS. It seemed that all the nice CD players were written for windows and I
  39. found nothing for DOS. Since I don't like using the mouse in text mode, I wrote
  40. a graphic player.
  41.  
  42.     The program has a very simple interface and includes all the buttons one
  43. would expect to find in an advanced CD player as well as a blank screen saver.
  44.  
  45.     The bottom row of buttons corresponds to usual commands (e.g. stop,play)
  46. where the play button serves also as pause (toggle).
  47.     The eject/close-tray button is on the right of the time display. When
  48. ejected or not ready, all buttons (except eject and PWR) are grayed (whited).
  49.     The top row of buttons contains special purpose buttons, which are (from
  50. left to right) : Power, Track display(enables to select a track), Statistics
  51. display(Show totals and progress bars), Direction(Toggles between increasing or
  52. decreasing time),Play mode (sequential, ordered or loop),Volume control,Mute and
  53. finally - About.
  54.     All the top row buttons are togglers (except PWR, of course).
  55.  
  56.  
  57. NOTE :  Volume control will work only for those devices that support it. It does
  58.         not make use of the sound card, therefore, the sound card itself should
  59.         be set to it's maximum level to get the full scale of the volume bar.
  60.  
  61.  
  62. 2. Instructions
  63. ===============
  64. I will provide instructions only for what isn't obvious.
  65.  
  66. 2.1. Screen saver
  67. -----------------
  68.     Will either operate after a specified time (see configuration) of no
  69. movement or when the mouse is moved to the upper-left corner of the screen and
  70. remains idle there for 1 second.
  71. Moving the mouse or pressing a letter key on the keyboard will shut off the
  72. screen saver and return the program to the screen.
  73.  
  74. 2.2. Configuration
  75. ------------------
  76.     Run cdconfig to change your defaults. Note that cdconfig modifies your
  77. executable, so don't run it after compressing cd-v.exe.
  78.     When in color configuration, you will have to specify your prefered colors
  79. for every item in cd-v. Most names in the configuration may not be obvoius and
  80. may need some explaining :
  81.  
  82. Button Face          - Button surface
  83. Frame Face           - Frame surface
  84. Background Color     - Background color for entire screen
  85. Screen Color         - Color for main data screen
  86. Title Color          - Color for background of the titles of boxes
  87. Active Text          - Color for active text and buttons (titles, time and
  88.                        sometimes buttons).
  89. Inactive Text        - Color for inactive text and buttons.
  90. Info Text            - Color for misc. info (play mode)
  91. Box Background Color - Color for box background (volume, track, order, about)
  92. Main Color           - Color for main screen background (main screen is the
  93.                        screen containing all vital buttons and the main data
  94.                        screen - It is what is left when all options are set
  95.                        to "off").
  96. Lighted sides        - Color for lighted sides of buttons and frames. Swapping
  97.                        it's value with that of "Dark sides" causes the 3d-look
  98.                        to be reversed.
  99. Dark sides           - Color for dark (unlighted) sides of buttons and frames.
  100. Border color         - Color for border of buttons and frames. Every button and
  101.                        frame is surrounded by a 1-pixel width line, which is
  102.                        normally black.
  103.  
  104. NOTE - keeping button face and frame face at light-gray, and not changing dark
  105.        and lighted sides ensures that the 3d-look is maintained. All other
  106.        colors may be changed freely and satisfactory results can easily be
  107.        achieved. A sample of a chnaged-color cd-v is shown in screen.pcx.
  108.  
  109.     Cdconfig.exe can be run with the command line option :
  110.         cdconfig -restore
  111.     Using this option restores cd-v.exe to the state it was after unzipping it
  112. from cd-v##.zip (default BW look).
  113.  
  114.  
  115. 2.3. Track order selection
  116. --------------------------
  117.     Press the Play-Mode button (drawn as 1-2-3 on diagonal) until ORD mode is
  118. indicated in the main window, and the track order list should appear as well as
  119. the track selection box (if it wasn't visible). The track list box will appear
  120. a bit different in this mode - instead of the heading ("Tracks"), there will be
  121. 2 buttons which functionality will be explained below.
  122.     If this is the first time this mode is selection during a run of the
  123. program, the list would be almost empty and the first entry whould appear as a
  124. pressed button with the value of 1.
  125.     Selection of a track from the track list changes the number in the currently
  126. pressed button in the order list and depresses the next slot on the order list.
  127. A specific slot in the order list can be selected by the mouse, and it's track
  128. number can be changed by the same way. Pressing the key '+' (or the key selected
  129. in the config file, defaulted to '`'),or the button marked '+' at the top of the
  130. track list, or the right mouse button when the cursor is positioned on the track
  131. list box, will depress a new empty slot in the bottom of the order list, if
  132. there is an empty one.
  133.     When choosing from the order list, you can always choose one of the tracks
  134. previously selected or the next-to-last selected track. You can't choose a
  135. specific button from the order list if there is an empty slot above it.
  136.     To erase the last entry to the list press the button marked '-' on the top
  137. of the track list, or press the RIGHT mouse button when the mouse pointer is
  138. positioned on any of the buttons of the order list. Keeping the button pressed
  139. longer the 2 secs will activate the autorepeat feature which will erase an entry
  140. every 0.2 secs as long as the button is pressed.
  141.     If your have a 3-BUTTON MOUSE, pressing the middle button while the cursor
  142. is positioned on the track list box, will cause the slot above the currently
  143. pressed to be active.
  144.     When leaving this mode, the track selection box will disappear if it wasn't
  145. visible when you entered the mode, or remain visible if it was visible before
  146. entering the mode.
  147.     Entering this mode another time will display the previously set list. The
  148. mode is NOT functional, however, when the list is not DISPLAYED.
  149.     The about box will disappear and not return (unless pressed again) if it was
  150. visible before entering the mode.
  151.  
  152. 2.4. AutoRepeat
  153. ---------------
  154.     When pressing a button longer than 1Sec, it gets released and if still
  155. pressed, will activate every 0.1Sec. Thus allowing true FF ,REW ,SKIP and PREV.
  156. The volume control autorepeat is faster ; The delay is only 0.5Sec and then then
  157. the button gets pressed every 0.01Sec (which is actually zero) and the volume is
  158. changed by a larger amount (10 levels instead of one with single press).
  159.     Note that some buttons have other delay values (see above).
  160.  
  161.  
  162. 3. Requirements
  163. ===============
  164. The program expects to find the following :
  165.  
  166. - Mouse (3-Button mouse is prefered) with MODERN mouse driver
  167. - MSCDEX version 2.20 or newer
  168. - VGA adapter
  169. - 386
  170.  
  171.  
  172. 4. Author
  173. =========
  174. The author can be reached by e-mail address :
  175.  
  176.         igrutman@bguee.bgu.ac.il
  177.  
  178. Please send any observation, remark or suggestion you might have.
  179. I will try and code your suggestions if I like them and have the time.
  180.  
  181.  
  182. 5. Thanks
  183. =========
  184. To Paul <something>, for being the first to contact me about the program.
  185.  
  186.  
  187. 6. Registration
  188. ===============
  189. This is a registered version. No further registration is needed.
  190.  
  191.  
  192. 7. History
  193. ==========
  194. 0.1  -  First version.
  195.  
  196. 0.2  -  Fixed bugs :
  197.         1. Font and screen drivers not found when run from another directory.
  198.            Fixed by moving them into the code thus leaving the only necessary
  199.            file to be cd-v.exe
  200.         2. Track length not updated in statistics window when track was changed
  201.            indirectly (by ff, rewind, or track finish).
  202.  
  203. 1.0  -  Added Track order selection for playing and indication of play mode
  204.         at the top-right corner of the time display.
  205.  
  206. 1.1  -  Fixed bugs :
  207.         1. Memory access violations causing strange screen behaviour.
  208.         2. When clicking on a blank slot from the track list, a number appeared.
  209.         3. Incorrect disk length when playing entire disk.
  210.  
  211. 1.2  -  Fixed bugs :
  212.         1. When entering without a CD and the tray is closed, the button would
  213.            operate properly (not operate) but would not get whited.
  214.         2. Tracks higher than 19 caused trouble due to incorrect BCD to decimal
  215.            conversion.
  216.  
  217.         Added features:
  218.         1. Added the ability to exit with the ESC key. ESC now functions as PWR.
  219.         2. Added AutoRepeat feature. When pressing a button longer than 1Sec, it
  220.            gets released and if still pressed, will activate every 0.1Sec. Thus
  221.            allowing true FF ,REW ,SKIP and PREV.
  222.         3. Added screen-saving ability.
  223.         4. Added configuration file cd-v.cfg
  224.  
  225. 1.3  -  Added features:
  226.         1. Added volume control.
  227.         2. Added the ability to change the system palette from the configuration
  228.            file.
  229.         3. Added the ability to change the initial state of commonly used
  230.            togglers.
  231.  
  232. 1.4  -  Added features:
  233.         1. Added mute button.
  234.         2. Added "sleep now" corner.
  235.         3. Ablitity to erase last entry from order list.
  236.         4. Use of the keyboard key '+' to add an empty entry to the order list
  237.            thus enabling faster filling of the list without running the mouse
  238.            back and forth.
  239.  
  240.         Arbitrary changes:
  241.         1. Swapped places of the buttons SKIP with PREV and FF with REW.
  242.  
  243.         Fixed bugs:
  244.         1. The program would terminate when pressing SKIP or PREV in ordering
  245.            mode and with the list empty. The list is now never really empty.
  246.  
  247. 1.5  -  Added features:
  248.         1. Added an entry in the config file to select one more key to function
  249.            as the key '+'.
  250.         2. Added two buttons on the track order selection buttons : Add new
  251.            entry and Remove last entry.
  252.  
  253. 1.6  -  Added features:
  254.         1. Added loop mode.
  255.         2. Added extensive color configuration.
  256.  
  257.         Arbitrary changes:
  258.         1. Choosing from the track list while in ORD mode causes the currently
  259.            pressed slot to descend.
  260.         2. In ORD, Pressing the middle button (on a 3-button mouse, and an
  261.            appropriate driver), while positioned in the track list box, causes
  262.            the currently selected slot to ascend.
  263.         3. In ORD, Pressing the right button, while positioned in the track list
  264.            box, causes the currently selected slot to descend.
  265.         4. When in SEQ mode, selecting a track from the track list starts
  266.            it, whether the player was playing before or not.
  267.         5. Changed length of "sleep-now" duartion from 2 to 1 Sec.
  268.         6. Removed configuration of system palette.
  269.         7. Move "+" and "-" buttons from the order list to the track box, during
  270.            ORD mode.
  271.  
  272.         Fixed bugs:
  273.         1. When in ordered mode, and the last selected track has finished, the
  274.            player would return to track 1 instead of the first selected track.
  275.  
  276. 1.7  -  Fixed bugs:
  277.         1. Pressing a track from the track list didn't change the play button to
  278.            a pause button.
  279.         2. Some buttons and texts appeared black even after color change.
  280.         3. The addition keys operated even when track selection list was not
  281.            visible.
  282.  
  283.         Added features:
  284.         1. Total disk time, when in track order mode, is the sum of all tracks
  285.            selected, and not the true disk total time.
  286.  
  287. 1.8  -  Added features:
  288.         1. Added scope and spectrum for sound blaster compatible cards
  289.  
  290.